<!DOCTYPE html>
<html prefix="og: http://ogp.me/ns#">
<head>
  <meta charset="UTF-8">
  <title>Atom</title>
  <link data-turbolinks-track="true" href="../../assets/application-b86a2086c99917c6bf2a9d74b4038381.css" media="all" rel="stylesheet" />
  <script data-turbolinks-track="true" src="../../assets/application-c3106c6fe52ccec6f26495730a478cca.js"></script>
  <meta content="authenticity_token" name="csrf-param" />
<meta content="yzXUiWH6GiCHbvbJOg7usjzA7LawyxwB+oJHEcWTOIM=" name="csrf-token" />
  <script>
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

  ga('create', 'UA-3769691-35', 'atom.io');
  ga('send', 'pageview');

</script>

  <meta property="og:url" content="../../index.html" />
<meta property="og:site_name" content="Atom" />
<meta property="og:title" content="A hackable text editor for the 21st Century" />
<meta property="og:description" content="At GitHub, we’re building the text editor we’ve always wanted: hackable to the core, but approachable on the first day without ever touching a config file. We can’t wait to see what you build with it." />
<meta property="og:type" content="website" />
<meta property="og:author" content='https://www.facebook.com/GitHub' />
<meta property="og:image" content="http://og.github.com/atom-logo/atom-logo@1200x1200.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="1200" />
<meta property="og:image" content="http://og.github.com/atom-mark/atom-mark@1200x630.png" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />

  <meta property="twitter:card" content="summary_large_image" />
<meta property="twitter:site" content="@AtomEditor" />
<meta property="twitter:creator" content='@github' />
<meta property="twitter:title" content="Atom" />
<meta property="twitter:description" content="A hackable text editor for the 21st Century" />
<meta property="twitter:image:src" content="http://og.github.com/atom-logo/atom-logo@1200x630.png" />
<meta property="twitter:image:width" content="1200" />
<meta property="twitter:image:height" content="630" />

  <link rel="shortcut icon" href="../../favicon.ico"/>
</head>
<body>

  <div class="footer-push">



    <header class="header">
  <div class="wrapper">
    <h1 title="Atom">
      <a href="../../index.html" class="logo"></a>
    </h1>

    <ul class="navigation">
      <li><a class="" href="../../packages.html">Packages</a></li>
      <li><a class="is-selected" href="index.html">Documentation</a></li>
      <li><a href="http://blog.atom.io">Blog</a></li>
      <li><a href="../../faq.html">FAQ</a></li>
      <li><a class="" href="https://atom.io/contact">Contact</a></li>
    </ul>
  </div>
</header>


    <div class="wrapper documents content-push">
  <div class="columns">
    <div class="column main-column markdown">
        <h1>
<a name="getting-started" href="index.html#getting-started"></a>入门</h1>

<p>欢迎来到Atom! 本指南提供一个迅速的说明，这样你可以尽早的使用上。这里还有覆盖<a href="../v0.69.0/customizing-atom.html">配置</a>, <a href="../v0.69.0/creating-a-theme.html">主题</a>, 和 <a href="../v0.69.0/creating-a-package.html">扩展</a> Atom.</p>

<h2>
<a name="the-command-palette" href="index.html#the-command-palette"></a>命令面板</h2>

<p>如果有一个快捷键你在Atom中必须记住的, 那肯定是<code>cmd-shift-P</code>. 你可以总是
按住<code>cmd-shift-P</code> 来弹出一个命令列表（快捷键）它和当前聚焦的界面元素相关
.这是一个伟大的方法来探索系统并且交互式学习快捷键。关于添加或者改变一个快捷键映射参见 <a href="../v0.69.0/customizing-atom.html">定制快捷键</a> 章节</p>

<p><img src="https://f.cloud.github.com/assets/1424/1091618/ee7c3554-166a-11e3-9955-aaa61bb5509c.png" alt="Command Palette"></p>

<h2>
<a name="the-basics" href="index.html#the-basics"></a>基础</h2>

<h3>
<a name="working-with-files" href="index.html#working-with-files"></a>和文件打交道</h3>

<p>Atom 窗口是局限于磁盘上的一个目录。如果你从命令行通过运行<code>atom</code>命令并且没有指定一个路径, Atom将打开一个
相对于当前工作目录的窗口。当前窗口目录将被可视化的当做左侧树形视图的根,并且服务于文件相关操作的情境（上下文）。</p>

<h4>
<a name="finding-files" href="index.html#finding-files"></a>查找文件</h4>

<p>最快方法找到一个文件就是试用模糊查找器. 按住<code>cmd-t</code> 然后开始输入你要找的文件名。如果你找到是已打开文件中的按 <code>cmd-b</code> 来弹出一个已打开文件的可搜索文件列表
。 如果你在使用Git 你可以用 <code>cmd-shift-b</code> 来搜索你代码仓库里修改过和未追踪过的文件列表。</p>

<p>你也可以试用树形视图来导航文件。要打开并聚焦树形视图，按<code>ctrl-0</code>. 树形视图可以被切换关闭通过
<code>cmd-\</code>.</p>

<h4>
<a name="adding-moving-deleting-files" href="index.html#adding-moving-deleting-files"></a>添加，移动，删除 文件</h4>

<p>你可以添加，移动，和删除文件和目录通过在树形视图中右键它们然后在右键菜单中选择想要的操作。你也可以执行这些操作在键盘通过选择一个文件或者目录然后试用<code>a</code> 来添加, <code>m</code> 来移动, 然后 <code>delete</code> 来删除。</p>

<h3>
<a name="searching" href="index.html#searching"></a>搜索</h3>

<h4>
<a name="find-and-replace" href="index.html#find-and-replace"></a>查找和替换</h4>

<p>要查找一个缓冲使用 <code>cmd-f</code>. 要搜索整个项目使用
<code>cmd-shift-f</code>.</p>

<h4>
<a name="navigating-by-symbols" href="index.html#navigating-by-symbols"></a>符号导航</h4>

<p>要跳至一个符号比如方法定义，按 <code>cmd-r</code>. 这时打开一个当前文件的符号列表, 你可以模糊过滤和
<code>cmd-t</code>相似。</p>

<p>要整个项目中搜索符号,使用 <code>cmd-shift-r</code>。首先 你将需要确保你项目的 <code>tags</code> (or <code>TAGS</code>) 文件生成。这可以通过安装<a href="http://ctags.sourceforge.net/">ctags</a>完成然后在命令行里项目目录中运行一个命令比如<code>ctags -R src/</code> 。 用 <a href="http://brew.sh/">Homebrew</a>? 只要运行
<code>brew install ctags</code>.</p>

<p>你可以定制如何生成你的tags通过创建自己的 <code>.ctags</code> 文件在你的主目录
 (<code>~/.ctags</code>)。这儿有可以起头的 <a href="https://github.com/atom/symbols-view/blob/master/lib/.ctags">一个好例子</a>。</p>

<h3>
<a name="split-panes" href="index.html#split-panes"></a>分割面板</h3>

<p>你可以分割任意编辑器面板水平或者垂直方向通过用 <code>cmd-k right</code>
或 <code>cmd-k down</code>。一旦你有一个分割面板，你可以在其中移动光标通过
 <code>cmd-k cmd-right</code> 或者 <code>cmd-k cmd-down</code>。 要关闭一个面板, 关闭全部编辑器通过
 <code>meta-w</code>, 然后按 <code>meta-w</code> 超过一次来关闭面板。你可以在Setting视图里配置面板为空时自动关闭。</p>

<h3>
<a name="folding" href="index.html#folding"></a>折叠</h3>

<p>你可以折叠代码块通过点击当你鼠标浮在左侧栏边缘时出现的箭头。你可以键盘上折叠和展开通过
keyboard with <code>alt-cmd-[</code> 和 <code>alt-cmd-]</code>。要折叠所有，用
<code>alt-cmd-shift-{</code> 要展开所有用 <code>alt-cmd-shift-}</code>。你也可以折叠一个特定的缩进级别通过
<code>cmd-k cmd-N</code> 这里 N 就是缩进的深度。</p>

<h3>
<a name="soft-wrap" href="index.html#soft-wrap"></a>Soft-Wrap</h3>

<p>如果你想切换soft wrap, 在命令面板中触发命令。
按 <code>cmd-shift-P</code>打开面板, 然后输入"wrap" 来找到正确的命令
。默认的, 行将基于编辑的尺寸断行。如果你想要指定一个行长在参数中选中 "Wrap at preferred line length"。</p>

<h2>
<a name="configuration" href="index.html#configuration"></a>配置</h2>

<p>按 <code>cmd-,</code> 打开设置视图。这就是改变设置，安装包和换主题的地方。</p>

<p>想了解更多高级配置，参见 <a href="../v0.69.0/customizing-atom.html">定制化指南</a>.</p>
    </div>
    <div class="column sidebar documents-toc">
      <select class="js-doc-version-switcher version-switcher">
  <option selected="selected" value="v0.69.0">v0.69.0</option>
<option value="v0.68.0">v0.68.0</option>
<option value="v0.67.0">v0.67.0</option>
<option value="v0.66.0">v0.66.0</option>
<option value="v0.65.0">v0.65.0</option>
<option value="v0.64.0">v0.64.0</option>
<option value="v0.63.0">v0.63.0</option>
<option value="v0.62.0">v0.62.0</option>
<option value="v0.61.0">v0.61.0</option>
<option value="v0.60.0">v0.60.0</option>
<option value="v0.59.0">v0.59.0</option>
<option value="v0.58.0">v0.58.0</option>
<option value="v0.57.0">v0.57.0</option>
<option value="v0.56.0">v0.56.0</option>
<option value="v0.55.0">v0.55.0</option>
<option value="v0.54.0">v0.54.0</option>
<option value="v0.53.0">v0.53.0</option>
<option value="v0.51.0">v0.51.0</option>
<option value="v0.50.0">v0.50.0</option>
<option value="v0.49.0">v0.49.0</option>
<option value="v0.48.0">v0.48.0</option>
<option value="v0.47.0">v0.47.0</option>
<option value="v0.46.0">v0.46.0</option>
<option value="v0.45.0">v0.45.0</option>
<option value="v0.44.0">v0.44.0</option>
<option value="v0.41.0">v0.41.0</option>
<option value="v0.40.0">v0.40.0</option>
<option value="0.52.0">0.52.0</option>
</select>


      <ul class="navigation">
        <li><a href="" class="is-selected">Documentation</a></li>
        <li><a href="../api/v0.69.0/api/index.html">API</a></li>
      </ul>

      <hr />

      <form accept-charset="UTF-8" action="/docs/v0.69.0/search" method="get"><div style="margin:0;padding:0;display:inline"><input name="utf8" type="hidden" value="&#x2713;" /></div>
        <input class="sidebar-search-field" id="q" name="q" placeholder="Search documentation" type="text" value="" />
</form>
      <h2>
<a name="guides" href="index.html#guides"></a>Guides</h2>

<ul>
<li><a href="../v0.69.0/getting-started.html">Getting Started</a></li>
<li><a href="../v0.69.0/customizing-atom.html">Customizing Atom</a></li>
<li><a href="../v0.69.0/creating-a-package.html">Creating a Package</a></li>
<li><a href="../v0.69.0/creating-a-theme.html">Creating a Theme</a></li>
<li><a href="../v0.69.0/publishing-a-package.html">Publishing a Package</a></li>
<li><a href="../v0.69.0/converting-a-text-mate-bundle.html">Converting a TextMate Bundle</a></li>
<li><a href="../v0.69.0/converting-a-text-mate-theme.html">Converting a TextMate Theme</a></li>
<li><a href="../v0.69.0/contributing.html">Contributing</a></li>
</ul><h3>
<a name="advanced-topics" href="index.html#advanced-topics"></a>Advanced Topics</h3>

<ul>
<li><a href="../v0.69.0/advanced/configuration.html">Configuration</a></li>
<li><a href="../v0.69.0/advanced/keymaps.html">Keymaps</a></li>
<li><a href="../v0.69.0/advanced/serialization.html">Serialization</a></li>
<li><a href="../v0.69.0/advanced/view-system.html">View System</a></li>
</ul>
    </div>
  </div>
</div>


    <div class="footer-pad"></div>
  </div>

  <footer>
  <div class="footer">
    <div class="wrapper">
      <ul class="footer-left">
        <li><a href="../../terms.html">Terms of Use</a></li>
          <li><a href="https://atom.io/login">Sign in</a></li>
      </ul>

      <div class="footer-right">
        <a href="https://github.com"><span class="octicon octicon-code"></span> with <span class="octicon octicon-heart"></span> by <span class="octicon octicon-logo-github"></span></a>
      </div>
    </div>
  </div>
</footer>

</body>
</html>
